متد SendSms :

برای ارسال پیامک باید از این متد استفاده نمود . پارامترهای مربوط به این متد در جدول ذیل آورده شده اند. مقدار بازگشتی این متد رشته ای است که مقادیر آن نشانگر شرایط پیامک می باشد. بدین ترتیب که اگر پارامترها صحیح باشند و پیامک به صورت موفقیت آمیز در سیستم پیام دهی قرار گیرد به ازای هر پیامک یک شناسه پیام (SmsId) و در غیر اینصورت کد خطای مربوطه در خروجی قرار می گیرد .

توجه: لیست انواع خطاها و توضیحات مربوط به هر کدام در انتهای این راهنما آورده شده است.

درهنگام ست کردن پارامتر متن به نکات زیر توجه فرمایید :

به طور کلی طول استاندارد هر پیامک 140 بایت است . در نتیجه طول استاندارد یک پیامک فارسی 70 کاراکتر (هر کاراکتر برابر 2 بایت است )، اندازه استاندارد پیامک باینری 140 بایت و طول استاندارد یک پیامک لاتین 160کاراکتر (160کاراکتر 7 برابر 2 بیتی) می باشد. باید به این نکته توجه داشته باشید که حتی وجود یک کاراکتر فارسی در پیامک باعث تغییر رمز نگاری آن پیامک شده و در نتیجه پیامک به طور کلی فارسی محاسبه می شود و طول آن بر اساس طول پیامک فارسی (70کاراکتر)در نظر گرفته خواهد شد.

جهت ایجاد سهولت برای مشترکین امکان ارسال پیامک های بزرگتر از طول استاندارد فراهم گشته است و مشترکین می توانند بدون نیاز به شکستن متن های طولانی،آن ها را به صورت یکپارچه ارسال نمایند.فقط در هنگام استفاده باید توجه داشته باشید که به ازای هر بخش از یک پیامک فارسی طولانی،3 کاراکتر و به ازای هر بخش از یک پیامک لاتین طولانی،7 کاراکتر از فضای استاندارد متن پیامک به کد UDH اختصاص پیدا می کند. یعنی در واقع هر بخش از پیامک چند قسمتی فارسی حداکثر 67 کاراکتر و هر بخش از پیامک چند قسمتی لاتین حداکثر 153 کاراکتر را در خود جای می دهد.

1. شماره گیرنده یا شماره موبایل که باید به طور مثال به صورت زیر در متد تعریف شوند:

0912XXXXXXXX

2. شماره فرستنده در هنگام ارسال می تواند به صورت زیر در متد تعریف شود:

3000XXXX

توضیح:برای ارسال پیامک هایی که طول آنها از طول استاندارد بیشتر است ، سیستم به صورت خودکار پیامک را به تعداد بخش لازم تقسیم کرده و ارسال می نماید. لازم به توضیح است که میزان اعتبار کسر شده ز کاربر بر اساس تعداد بخش های متن پیام می باشد.

3. با تنظیم پارامتر SmsMode می توان نحوه دریافت و نمایش پیامک ارسالی بر روی گوشی گیرنده را به دلخواه تغییر داد، مقادیر قابل قبول برای این پارامتر سه مقدار Alert,SaveInPhone,SaveInSim می باشد.

Alert: پیامک به صورت مستقیم بر روی صفحه موبایل شخص گیرنده فرستاده می شود . در این حالت پیامک در موبایل یا سیم کارت شخص گیرنده به صورت اتوماتیک ذخیره نمی شود و با خروج از آن از روی گوشی حذف می شود(پیامک خبری).

SaveInPhone: پیامک در حافظه موبایل شخص گیرنده ذخیره می شود(پیامک عادی )

SaveInSim: پیامک بر روی حافظه سیم کارت شخص گیرنده ذخیره می شود.

چند نکته مهم:

· طول استاندارد پیامک :

سایز استاندارد پیامک 140بایت می باشد. در صورتیکه در متن پیامک از کاراکترهای Adphanumeric استفاده شود طول یک پیامک حداکثر می تواند 160 کاراکتر و در صورتی که از Unicode دوبایتی (کاراکترهای فارسی ) استفاده شود طول یک پیامک حداکثر 70 کاراکتر می تواند باشد.

انواع حالتهای ممکن ارسال پیامک از طریق متد SendSms :

- ارسال پیام به صورت نظیر به نظیر:

در این حالت تمام پارامترهای متد باید دارای آرایه ای هم سایز و متناظر با آرایه پارامتر شماره دریافت کنندگان باشد. در این صورت می توان پیامک های گوناگونی به گیرندگان ارسال نمود.در این صورت باید پارامتر SendType از نوع DynamicText به تابع انتقال داده شود.

- ارسال پیامک به صورت یک به چند (بالک) :

ن حالت تمام پارامترهای متد به جز پارامت شماره دریافت کنندگان باید دارای آرایه ای به طول یک باشددر این صورت یک متن واحد برای چندین نفر (شماره گیرنده) فرستاده می شود. در این صورت باید پارامتر SendType از نوع StaticText به تابع انتقال داده شود.